home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr33 / 3mlrprog.zip / MLRPUB20.EXE / pak / PUBLIC.TXT < prev    next >
Text File  |  1992-11-15  |  28KB  |  535 lines

  1.  
  2.                            * * *  My Little Realm, v2.0  * * *
  3.  
  4.                                  -  Public Library/sa  -
  5.           ____________________________________________________________________
  6.           
  7.                                    General Information
  8.           ____________________________________________________________________
  9.  
  10.                                         Important
  11.  
  12.           This is the Shareware version of Public Library.  It is a 
  13.           full-featured, fully functional program that maintains an Historical
  14.           file of a maximum of 50 records.
  15.  
  16.           The Registered version will hold as many records in the Historical
  17.           file as will fit in your conventional RAM.  
  18.  
  19.           Thank you for trying Public Library!
  20.           ______________________________________________________________________
  21.  
  22.           Introduction.
  23.  
  24.           This routine is really two programs in one.  It keeps track of the
  25.           outstanding books, magazines, videos, etc., that you borrow from 
  26.           your public library on the one hand, and it also maintains an 
  27.           historical file of your borrowings so that you can see what you and 
  28.           your realm members have been reading over the years.
  29.  
  30.           The Historical Mode contains a powerful Search function that lets
  31.           you find records with specific information in a given field.  For
  32.           example, if you wanted to see what one member of the realm has been
  33.           reading, simply invoke the Search function, select the Reader field 
  34.           to search on, and then enter the reader's Quickey.  Public Library
  35.           will display all of the works that that reader has borrowed over 
  36.           the years.  You can even print the results, if you like.
  37.  
  38.           Public Library is a great way to keep track of research material,
  39.           too, especially for high school students who tend to be somewhat
  40.           less than organinzed.  It also helps minimize the book and video
  41.           fines (in some areas 25 cents and a dollar, respectively) that can 
  42.           add up so quickly.
  43.  
  44.           To find out what you have outstanding at any point in time, just
  45.           run Public Library and press <2> in the Options Window.  It's that
  46.           easy.
  47.           ____________________________________________________________________
  48.  
  49.                                     The Interface
  50.  
  51.           Windows.
  52.  
  53.           Public Library's screen consists of three types of windows:  a 
  54.           Working Window, a Viewing Window, and an Options Window.  If you are 
  55.           using a color monitor the Viewing Window is always green, the 
  56.           Working Window red and the Options Window blue.  Enter the pound
  57.           sign, <#>, in the Options Window to install the color mode.
  58.  
  59.           You select processes (like adding a record) in the Options Window.  
  60.           You create records in the Working Window, and you view your records 
  61.           in the Viewing Window.
  62.  
  63.                              ----------------------------
  64.  
  65.           Extended processing options.
  66.           
  67.           Several processing tasks, called extended processing options or 
  68.           EPO's, are not listed in the Options Windows, because they are 
  69.           functions that only occasionally need to be performed.  EPO's are
  70.           used to "extend" a program's power and functionality.
  71.  
  72.           To find out what EPO commands are employed by Public Library/sa, 
  73.           enter <?> (the question mark) in the Options Window.  The EPO's of 
  74.           Public Library are defined at the end of this document.
  75.  
  76.                              ----------------------------
  77.  
  78.           Quickeys.
  79.  
  80.           There are two types of Quickey lists in the Public Library Routine.  
  81.           The first is for the names of the readers of your realm, or, more 
  82.           precisely, for their initials.  The second group of Quickeys is for
  83.           your libraries.
  84.  
  85.           The Quickeys in Public Library/sa give you single key access to the 
  86.           names of the readers in your realm and to the libraries you
  87.           frequent.  Enter them once, and you'll never have to enter them 
  88.           again.  See the section "Extended Processing Options" for full 
  89.           details.
  90.           ____________________________________________________________________
  91.  
  92.                                    Getting Started
  93.  
  94.           Note:  If you have a color monitor, press <#>, the pound sign, in 
  95.           the Options Window to install the color mode.
  96.  
  97.           The very first thing you'll want to do with Public Library is make 
  98.           the program uniquely yours.  To do that, you will have to enter the
  99.           names of the readers in your realm and libraries you visit.  The 
  100.           Change Quickeys function is invoked by the backslash key, <\>,
  101.           entered in the Options Window.
  102.  
  103.           Public Library will first ask which Reader Quickey you want to 
  104.           change.  The reader entry can be up to three letters long; initials
  105.           are usually used.  When you've entered all of your readers (you can 
  106.           enter up to six), Public Library will ask for the names of the 
  107.           libraries you visit.  You can enter up to four, and they can be
  108.           up to ten characters in length.
  109.  
  110.           Recommended reading:  Please take a few moments to peruse this
  111.           document.  While Public Library/sa is not difficult to learn, it
  112.           can do a great deal more than simply remind you which books are
  113.           out, who borrowed them, and when they're due.
  114.           ____________________________________________________________________
  115.  
  116.                                   Program Information
  117.           ____________________________________________________________________
  118.  
  119.           
  120.           Options Window for the Outstanding (Books Due) mode.
  121.                         _______________________________________     
  122.                        |                                       |
  123.                        |  1  Enter new books     4  Delete     | \
  124.                        |  2  Return  books                     |  \
  125.                        |  3  Change/View           Choice:  _  |    \       
  126.                        |_______________________________________|     \
  127.                                                                      
  128.                                                                      <enter>    
  129.           Options Window for the Historical mode.
  130.                         _______________________________________       /
  131.                        |                                       |     /
  132.                        |    A  View             D  Search      |    /
  133.                        |    B  Sort             E  Delete      |   /
  134.                        |    C  Print              Choice:  _   |  /
  135.                        |_______________________________________|
  136.                        
  137.  
  138.                               ++   The Outstanding Mode   ++
  139.           
  140.           The Public Library works in two modes:  Outstanding and Historical.  
  141.           To switch between the two modes press <enter> in the Options Window.  
  142.           You'll see the options in the Options Window change as shown above,
  143.           and the title box alternately displays "Outstanding Mode" and 
  144.           "Historical Mode".
  145.           
  146.           The first mode deals with the books that are currently due at your 
  147.           libraries.  In other words, if you've just taken a book out of one
  148.           of your local libraries or returned one, use the Outstanding Mode 
  149.           to make or update the necessary records.
  150.           
  151.           Note:  Public Library always starts in the Outstanding mode.
  152.  
  153.           The second mode is the Historical mode which maintains a list of 
  154.           all of the works you've ever borrowed and returned.  It is 
  155.           described later in this document.
  156.  
  157.                                   ~ Field Definitions ~
  158.  
  159.           - Title field (35, required).
  160.  
  161.           Leading prepositions and articles should be placed at the end of the 
  162.           title so that sorting takes place on the first key word.
  163.  
  164.                                    Title:  Tontine, The
  165.                                    ____________________
  166.  
  167.           - Author field (30 total, optional).
  168.  
  169.           In the Public Library function, an author's name is entered in the
  170.           following manner:
  171.  
  172.                                       Last:  Costain
  173.                                      First:  Thomas
  174.                                      M. I.:  B
  175.  
  176.           To skip the author entry entirely, press <enter> when the cursor is 
  177.           in the first position on the Last name line.  The First and M. I. 
  178.           name lines can be skipped by pressing <enter>.
  179.                                    ____________________
  180.  
  181.           - Date field (required).
  182.  
  183.           This field is constructed along the manner of the American date 
  184.           format of mm/dd/yy.
  185.  
  186.           Public Library will accept dates in the Public Library Routine that 
  187.           are up to one year in the future (remember, these are due dates), 
  188.           and it will accept records with dates from the current and previous 
  189.           months, just in case you don't get the books logged promptly.  
  190.                                    ____________________
  191.  
  192.           - Library Quickey field (single character entry, optional).
  193.  
  194.           Only Quickeys are accepted in this field.  You cannot manually enter
  195.           a library name.  So if you want to enter a library name for a given
  196.           record you must do it using the Quickeys.  To skip this field simply 
  197.           press <enter>.  
  198.  
  199.           Public Library will display the libraries you listed in your library 
  200.           Quickey file (up to four are allowed) in the box on the lower right 
  201.           side of your screen.  
  202.                                    ____________________
  203.  
  204.           - Reader Quickey field (3, optional).
  205.  
  206.           Enter one of the six Quickeys in this field.   The Reader Quickeys 
  207.           are displayed in the box in the lower right part of your screen.
  208.  
  209.           You don't have to use a Quickey, however.  Any character string from 
  210.           one to three letters long may be entered, but only letters may be 
  211.           used.  Numbers are recognized solely as Quickey entries, and only 
  212.           <1> through <6> are accepted.
  213.                                    ____________________
  214.  
  215.           Echoic entries:  Date, Library and Reader fields.
  216.  
  217.           The Date, Library and Reader fields are echoic entries.  That is to
  218.           say, once a record has been entered, each of these fields will echo 
  219.           its previous value to the screen in subsequent records until you
  220.           alter its value or exit the Enter New Books function.  If the echoed 
  221.           value is the entry you want, just press <enter>.  
  222.  
  223.           For example, if you borrow six magazines from your local library and 
  224.           all of them have the same due date, you only have to enter the date 
  225.           for the first record.  After that, Public Library will echo that 
  226.           date and all you have to do is press <enter> to accept it.  The same 
  227.           procedure holds for the library and reader entries.  
  228.  
  229.           Should you wish to change an echoed value for the Reader or Library
  230.           entries, merely pretend it isn't there and enter what you would have 
  231.           had the echo not been displayed.  To change the Date echo, press the
  232.           <backspace> key.  You can also backspace over the Reader and Library
  233.           echoes if you prefer.
  234.           ______________________________________________________________________
  235.  
  236.           Option # 2, returning your books.
  237.  
  238.           At a glance, the Public Library's Return function can tell you:
  239.  
  240.                        the titles of the works currently on loan
  241.                        the authors of each
  242.                        the date each work is due
  243.                        who borrowed said works, and
  244.                        the library to which each must be returned
  245.                             (should you frequent more than one library)
  246.  
  247.           Public Library automatically displays your outstanding books in the 
  248.           Viewing Window and asks for the record number of the book you have 
  249.           returned.  (The record numbers are displayed on the left side of the 
  250.           Viewing Window.)  
  251.           
  252.           Enter the record number of each of the works you have returned, and
  253.           Public Library will highlight them.  When you've highlighted all of 
  254.           those returned, press <enter> without entering a record number.  
  255.           
  256.           If you've highlighted any of the works, Public Library will display 
  257.           the following confirmation prompt:
  258.                       
  259.                       ____________________________________________
  260.                      |                                            |
  261.                      |   Press <enter> to confirm your returns.   |
  262.                      |   Press <esc> to abort return function.    |
  263.                      |   Press <backspace> to recheck returns.    |
  264.                      |____________________________________________|
  265.  
  266.           
  267.           You have three options here:  Press <enter> to tell Public Library
  268.           to go ahead and update the books due file; press <esc> to leave the
  269.           Return function without updating the books due file; or press the
  270.           backspace key to go back to the beginning of the Return function
  271.           and make some last minute changes (like highlighting another record 
  272.           or turning off a highlighted record).
  273.  
  274.           Note:  Public Library does not remove the records marked returned
  275.           from the Outstanding file and append them to the Historical file
  276.           until you exit the Public Library program.  This means that if you 
  277.           mark several works returned and then decide to view the Historical 
  278.           file, you won't find your recently returned records at the end of 
  279.           the file.  All of the file I/O is performed when you exit the 
  280.           program.  Hence, the returned works can still be viewed by invoking 
  281.           the Return function.  On the next occasion you use Public Library, 
  282.           you'll find those returned books in the Historical file.
  283.  
  284.                                    ___________________
  285.  
  286.           You can use this function to view your books due file (properly 
  287.           called the Outstanding file).  If you have more than one screenful
  288.           of books, you can use the directional keys, <home>, <end>, <pageup>,
  289.           and <pagedown> to view the others.  When you've finished, press 
  290.           <esc>.  
  291.  
  292.           Note:  If you are merely viewing your records, remember that you 
  293.           should not highlight them in this function.  If you do, they will be 
  294.           considered "returned", and Public Library will display the 
  295.           confirmation prompt shown above.  If you should happen to forget,
  296.           simply press <esc> when the confirmation prompt is displayed and
  297.           Public Library will ignore your highlighted records and return to
  298.           the Options Window.
  299.  
  300.           Important:  You should ensure that all entries are correct while the
  301.           records are in the books due file.  Once a record is marked 
  302.           returned, it is moved to the Historical file and cannot be modified.
  303.           ______________________________________________________________________
  304.  
  305.           Option # 3, correcting and viewing records.
  306.  
  307.           Public Library will want to know the record number.  The record
  308.           numbers appear on the left side of the Viewing Window.  To return to 
  309.           the Options Window, press <enter> (without entering a record number) 
  310.           or press <esc>.
  311.  
  312.           After you enter a record number, it displays a sub-menu of the 
  313.           fields that you can change in the Working Window and highlights the 
  314.           record in the Viewing Window so you'll know which record's data 
  315.           you're changing.  Be sure you have the correct one.  To turn off the 
  316.           highlight (i.e., to avoid making changes to the highlighted record), 
  317.           press <enter> (nothing else) or press <esc>.
  318.  
  319.           When the sub-menu is displayed showing the six fields you can 
  320.           change, select the appropriate field's hotkey, and Public Library 
  321.           asks for the new field value.  If you enter the wrong hotkey press 
  322.           <esc> and Public Library will restore the original value.  
  323.  
  324.           If the menu number you chose was <6> (return status), you can undo 
  325.           the change by simply entering <6> again.  Since the return status is 
  326.           either yes or no, all you do to change the status is to select menu 
  327.           number <6>.  The instant you select <6> the return status is changed 
  328.           to the opposite value.  To change it back, you simply press <6> 
  329.           again.
  330.  
  331.           This function is also handy if you simply want to peruse your books
  332.           due file.  If you have more than a screenful, you can use the 
  333.           scrolling keys to view those records not on screen.
  334.  
  335.           Important:  You should ensure that all entries are correct while the
  336.           records are in the books due file.  Once a record is marked returned,
  337.           it is moved to the Historical file and cannot be modified.
  338.           ______________________________________________________________________
  339.  
  340.           Option # 4, deleting your records.
  341.  
  342.           Public Library will ask for the record number of the entry you want 
  343.           to delete.  It will then highlight that record and ask you if you 
  344.           are sure you want that record deleted.  Verify the contents of the 
  345.           record before you respond.  If you respond <Y>, the record is
  346.           deleted.  If you press <esc>, <N>, or <enter>, Public Library will
  347.           turn off the highlight.
  348.  
  349.           After you respond yes or no, Public Library will again ask for the 
  350.           record number of the next record you want to delete.  Give it the 
  351.           next record number if you want to delete another record or press 
  352.           <esc> (or <enter> without entering a record number) to leave the 
  353.           Delete function and return to the Options Window.  If you delete the 
  354.           last record in your books due file, you will automatically be 
  355.           returned to the Options Window.
  356.           ______________________________________________________________________
  357.           ______________________________________________________________________
  358.  
  359.                              ++   The Historical Mode   ++
  360.  
  361.           When you press <enter> in the Options Window, Public Library
  362.           switches between the Outstanding mode and the Historical mode.  If
  363.           Public Library is in the Outstanding Mode, simply press <enter> to 
  364.           access your Historical file.  Public Library displays "Historical 
  365.           Mode" in the title box on the upper right of your screen.
  366.  
  367.           The Historical mode of the Public Library Routine allows you a 
  368.           unique perspective on your realm members' reading habits over the 
  369.           years.  There might also be times when you want to go back and 
  370.           re-read an unusual work you had read years before but can't quite 
  371.           recall the name of the work or the author.  
  372.           
  373.           The historical log also allows you to keep detailed records of your 
  374.           research.  And if friends ask what the children of the realm were 
  375.           reading when they were such and such an age, you'll be able to look 
  376.           up the answer quickly and easily using Public Library's Search
  377.           function.
  378.           
  379.           Note:  The records of the works declared returned in the 
  380.           Outstanding Mode are added to the Historical file when you exit 
  381.           the Public Library program.  Public Library puts those returned 
  382.           records at the end of the Historical file, maintaining a nearly 
  383.           chronological account of your borrowings.  This structure of the 
  384.           Historical file is not altered by Public Library's Sort function.
  385.           ______________________________________________________________________
  386.  
  387.           Option <A>, viewing the historical records.
  388.  
  389.           Use the directional keys, <home>, <end>, <pageup>, and <pagedown> to 
  390.           browse.  You can have Public Library highlight specific records by 
  391.           entering the record numbers of those you want to focus on.  To turn 
  392.           off a record's highlight, reenter that record's record number.
  393.  
  394.           To return to the Options Window, press <enter> (without entering a
  395.           record number) or press <esc>.
  396.           ______________________________________________________________________
  397.  
  398.           Option <B>, sorting the historical records.
  399.  
  400.           You may sort by title, author or reader.  If you wish to print your
  401.           records in a sorted order, run the sort first and then run the Print
  402.           function (option <C>).
  403.           ______________________________________________________________________
  404.  
  405.           Option <C>, printing the historical records.
  406.  
  407.           Public Library prints the title, author, date (due), library, and 
  408.           the reader.  If you want your listing in a sorted order, run the 
  409.           sort first, then invoke the Print function.
  410.           ______________________________________________________________________
  411.  
  412.           Option <D>, searching the historical records.
  413.  
  414.           You can tell Public Library to search on any of four fields:  the 
  415.           Title field, the Author field, the Date field, or the Reader field.  
  416.           Give Public Library the string (called a keyword) that you're 
  417.           looking for, and it will search the specified field in every record 
  418.           for any occurrence of the keyword.
  419.  
  420.           Normally, Public Library deletes the external spaces surrounding a 
  421.           keyword.  For the Title and Author fields, however, you can include 
  422.           a special delimiter, the backslash, to force Public Library to 
  423.           include blank spaces when it conducts its search.  As an example, if 
  424.           you wanted to look at all of the volumes whose author was "Long", 
  425.           you would enter: 
  426.  
  427.                                    \Long \
  428.  
  429.           This type of keyword search would eliminate those authors with names
  430.           like Longacre or Longfellow.
  431.  
  432.           Entering a date string is easy.  You can search on a year or on a 
  433.           specific month and year combined.  Below are examples of valid date 
  434.           entries for the year 1985.
  435.  
  436.                                    1985
  437.                                    85
  438.                                    /85
  439.  
  440.           If you want Public Library to restrict the search to a specific 
  441.           month, enter:
  442.  
  443.                                    7/85
  444.                                    07/85
  445.  
  446.           Public Library ignores the day portion of the dates.  If you 
  447.           include the day portion of the date, i.e., if you enter 7/24/85 for 
  448.           example, Public Library will use only the month and the year, 
  449.           providing they are valid entries.
  450.           ______________________________________________________________________
  451.  
  452.           Option <E>, deleting the historical records.
  453.  
  454.           This Delete function is a little different from the one in the 
  455.           Outstanding mode.  In the Outstanding mode, you delete one record at 
  456.           a time.  In the Historical mode, you select all of the records you 
  457.           want to delete and then have Public Library delete them all at one 
  458.           time.  Confirmation is required before the deletions are performed.
  459.  
  460.           Use the directional keys, <home>, <end>, <pageup>, and <pagedown> 
  461.           to find the records you want to delete, and enter their record 
  462.           numbers.  Public Library will highlight your selections.  After 
  463.           you've highlighted all of the records you want to delete, press 
  464.           <esc> or <enter> (without entering a record number).
  465.  
  466.           If you've highlighted any records, Public Library will tell you how 
  467.           many records you've marked for deletion and ask if you want the 
  468.           deletions made.  Respond <Y> to effect the deletions.  Press <N>, 
  469.           <enter>, or <esc> to abort the Delete function.  
  470.  
  471.           If you highlight a record and then change your mind, enter that 
  472.           record number again, and Public Library will turn off the highlight.  
  473.           Only highlighted records are deleted.
  474.  
  475.           Special note:  If you have sorted your records before running the
  476.           Delete function, Public Library will tell you that it will restore 
  477.           the historical array to its original structure before it continues 
  478.           with the Delete function.  If you have more work to do using the 
  479.           sorted structure, you might want to finish that work first before 
  480.           you delete any records.
  481.           ______________________________________________________________________
  482.           ______________________________________________________________________
  483.  
  484.           Extended Processing Options.
  485.  
  486.                EPO  Definition
  487.                          
  488.                <\>  Change the Quickeys.  Both reader and library Quickeys are 
  489.                     changed by issuing this command.  
  490.                     
  491.                     Reader Quickeys can be three characters long.  
  492.                     
  493.                     Library Quickeys can be up to ten letters long.  
  494.  
  495.                                     - - - - - - - - -
  496.                
  497.                <$>  Print an order form for My Little Realm's Public Library.
  498.           
  499.                                     - - - - - - - - -
  500.                
  501.                <?>  Display the EPO's for the Public Library Routine.
  502.  
  503.           ______________________________________________________________________
  504.  
  505.                                 On reading . . .
  506.                    
  507.           Americans deny themselves a valuable resource when they ignore 
  508.           their public libraries.  A chance to read is a chance to explore 
  509.           ... the world around us, the world inside us.  It enhances lives 
  510.           by enlarging the worlds we perceive physically, spiritually, 
  511.           metaphysically, and metaphorically.
  512.  
  513.           Like looking through different lenses on a sophisticated camera,
  514.           reading allows you to view your world with whole new perspectives.
  515.           The works you read don't have to be revolutionary to make you
  516.           think.  Nor do they have to be written by Nobel Prize winning 
  517.           authors to have impact.  And they certainly don't have to appear on 
  518.           the best selling lists to entertain.  But they do have to be read 
  519.           to be enjoyed.
  520.  
  521.           Do yourself a favor.  Keep a library book around the realm, even 
  522.           if you're not sure you'll have time to finish it.  There's no rule 
  523.           that says you have to read it cover to cover.  And if, at a later 
  524.           date, you decide you really do want to finish that book but you 
  525.           can't recall the name of the author or the title, don't worry about 
  526.           it ... My Little Realm's Public Library will remember for you.
  527.           
  528.           ______________________________________________________________________
  529.  
  530.                                       +  The End  +
  531.           ______________________________________________________________________
  532.  
  533.           (c) Copyright 1991 - 1992 John L. Salisbury
  534.  
  535.